cli-settings

This command configures various CLI settings.

Syntax

(config-system)# cli-settings
(cli-settings)#

Command

Description

cli-alias

Defines the CLI Aliases table (see cli-alias).

default-window-height

Defines the number (height) of output lines displayed in the CLI terminal window. This applies to all new CLI sessions and is preserved after device resets.

The valid value range is -1 (default) and 0-65535:

■ A value of -1 means that the parameter is disabled and the settings of the CLI command window-height is used.
■ A value of 0 means that all the CLI output is displayed in the window. If the window is too small to display all the lines, the window displays all the lines by automatically scrolling down the lines until the last line (i.e., the "—MORE—" prompt is not displayed).
■ A value of 1 or greater displays that many output lines in the window and if there is more output, the “—MORE—" prompt is displayed. For example, if you configure the parameter to 4, up to four output lines are displayed in the window and if there is more output, the “—MORE—" prompt is displayed (at which you can press the spacebar to display the next four output lines).

Note: You can override this parameter for a specific CLI session and configure a different number of output lines, by using the window-height CLI command in the currently active CLI session.

direct-exec {off|on}

Enables users with Security Administrator privileges to skip the enable command and start in enabled mode (Privileged User) by default upon CLI login. For more information on this mode, see Privileged User Mode.

idle-timeout {off|on}

Defines the maximum duration (in minutes) that a CLI session may remain idle, before being disconnected.

password-obscurity {off|on}

Displays passwords in encrypted (obscured) format in the output of the show running-config command. The word "obscured" is also shown to indicate that it's an encrypted password. Below shows an example of an obscured password configured for a Remote Web Service (http-remote-services):

rest-password 8ZybmJHExMTM obscured

password-history-visible {off|on}

Hides passwords (default - off) by replacing them with asterisks (*) in the CLI's command history buffer (see history).

privilege-password

Defines the password for the privilege (Enable) mode.

ssh {off|on}

Enables secure access using SSH.

ssh-acl

Assigns an Access List entry (client) permitted to access the SSH interface. The Access List is configured by the access-list command.

ssh-admin-key

Defines the RSA public key (hexadecimal) for SSH client login.

ssh-ciphers-string

Defines the SSH cipher string.

ssh-if

Defines the SSH Interfaces table (see ssh-if).

ssh-kex-algorithms-string

Defines the SSH Key Exchange Algorithms.

ssh-last-login-message {off|on}

Enables the display of the last address from which the user logged into the SSH server.

ssh-macs-string

Defines the SSH MAC algorithms.

ssh-max-binary-packet-size

Defines the maximum SSH binary packet size.

ssh-max-login-attempts

Defines the maximum number of SSH login attempts.

ssh-max-payload-size

Defines the maximum size of the SSH payload (in bytes).

ssh-max-sessions

Defines the maximum number of SSH sessions.

ssh-require-public-key {off|on}

Enables SSH authentication via RSA public key.

ssh-red-device-port

Defines the proxy SSH port number on the active device for accessing the redundant device's embedded SSH server from the active device for downloading files from the redundant device.

Note: The command is applicable only to device's in HA mode.

telnet-if

Defines the Telnet Interfaces table (see telnet-if).

telnet-mode {disable|enable|ssl-only}

Enables Telnet access to the device.

telnet-acl

Assigns an Access List entry (client) permitted to access the Telnet interface. The Access List is configured by the access-list command.

telnet-max-sessions

Defines the maximum number of Telnet sessions.

verify-telnet-cert {disable|require}

Enables or disables verification of peer (client) certificate by Telnet server.

window-height {0|1-65535|automatic}

Defines the height of the CLI terminal window for the current CLI session only:

■ 0: All the CLI output lines are displayed. If the window is too small to display all the lines, the window displays all the lines by automatically scrolling down the lines until the last line (i.e., the "—MORE—" prompt is not displayed).
■ 1-65535: Defines the number of lines to display in the window.
■ automatic: Whenever you manually change the height of the window (i.e., by dragging with the mouse), the new size is automatically saved.

Note: The window height can be configured for all sessions using the CLI command, default-window-height.

Command Mode

Privileged User

Example

The example configures the CLI terminal window height to 15 lines:

(config-system)# cli-settings
(cli-settings)# window-height 15